home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d19
/
cal14s6.arc
/
CALLS.DOC
< prev
next >
Wrap
Text File
|
1988-12-31
|
11KB
|
279 lines
CALLS.EXE
Call analyzer for PCBoard versions 11.7
(updated for PCBoard 11.8 and PCB/ProDOOR, S.H.Smith, 07/05/87)
(updated for PCBoard 12.1, S.H.Smith, 01/16/88)
Note: Warren Lauzon is no longer supporting this program
(since he's completely rewriting it)
So, please don't bother him with support questions.
If you need help with it, contact me at
Samuel H. Smith,
Sysop, The Tool Shop
(602) 279-2673
CHANGE HISTORY (in reverse order)
=================================
Added color output files.
Added support for 4800 baud connections.
Corrected formatting in bar graphs for items with 100%.
Version 14s6 31-Dec-88 S.H.Smith
-----------------------------------------------------------------------
Removed ARC-specific terminology. Updated for similar changes in
ProDoor betas dated after 10-9-88.
Version 14s4 10-Oct-88 S.H.Smith
-----------------------------------------------------------------------
Added a report of "Free Downloads" for compatibility with 9/30
prodoor betas.
Added a "Peak Hours" command line parameter.
Deleted "Time Distribution" report because it was so slow and inaccurate.
Usage:
calls callers-file output-file report-list min-downloads peak-hours
callers-file is your pcboard CALLER file
output-file defaults to CALLFILE.DOC
report-list defaults to ANBCDEFGHIJKLM
min-download defaults to 2
peak-hours defaults to YNNNNNNNNNNNNNNNNYYYYYYY
{0 1 2 }
{012345678901234567890123}
Examples:
calls \pcb\main\caller \gen\blt3
calls \pcb\main\caller \gen\blt3 ABCEFG 4 NNNNNNNNYYYYYYYYYNNNNNNN
The legal report-list letters are:
A: system statistics B: graphic modes
C: baud rates D: hourly usage
E: conferences joined F: bulletins read
G: doors opened H: download protocols
I: download efficiency J: upload protocols
K: upload efficiency L: batch sizes
M: files downloaded N: security statistics
Z: insert a blank line
Version 14s3 10-03-88 S.H.Smith
-----------------------------------------------------------------------
Updated for new conference joined and bulletin read log formats.
Added a check for empty caller log files.
Version 14s2 24-Sep-88 S.H.Smith
-----------------------------------------------------------------------
Updated protocol letters for PCBoard 14 compatibility.
Version 14s1 20-Sep-88 S.H.Smith
-----------------------------------------------------------------------
Updated new user registration for new PCB 14 message format.
Version 12s21 22-Jul-88 S.H.Smith
-----------------------------------------------------------------------
Added support for node chat.
Version 12s20 22-Jun-88 S.H.Smith
-----------------------------------------------------------------------
Added a new data file CALLS.DIR, and a new graph of Time Usage by Activity.
Create the file CALLS.DIR in the current directory. List all your download
and upload directories in this file (one directory per line). CALLS will
use this to search for each file that has been downloaded or uploaded. The
files must be located to determine file size, which is used to calculate the
minutes spent downloading and uploading. File sizes are determined only the
first time a file is seen.
Version 12s19 12-Jun-88 S.H.Smith
-----------------------------------------------------------------------
Changed ARCM message counter to a long integer to prevent overflows.
Version 12s17 10-May-88 S.H.Smith
-----------------------------------------------------------------------
Added support for ProDoor's new ARC Mail feature.
Version 12s16 16-Apr-88 S.H.Smith
-----------------------------------------------------------------------
Added checks for 24:xx instead of 00:xx in some caller log entries.
Should prevent some runtime errors.
Version 12s15 12-Mar-88 S.H.Smith
-----------------------------------------------------------------------
Recompiled with stack and range check enabled - slower, but safer.
Version 12s14 11-Feb-88 S.H.Smith
-----------------------------------------------------------------------
Improved bulletin activity report formatting.
Made changes to allow caller logs with over 32000 entries. Changed graphics
to allow > 100% (for MNP modems in efficiency reporting).
Version 12s13 11-Feb-88 S.H.Smith
-----------------------------------------------------------------------
Made the 'remote dos time' statistic work properly (broken ever since
PCB 12.) Added entries in protocol table for all letters of
the aplhabet.
Version 12s12 19-Jan-88 S.H.Smith
-----------------------------------------------------------------------
Added the ability to store an internal summary of your caller log.
This makes it possible to add small daily caller logs and produce
the full report without keeping the whole caller log on file. It
also reduces time spent scanning the log file.
Each time CALLS is run, it looks for CALLS.SAV in the default
directory. If it is present, it loads this "saved summary" into
memory and adds the specified caller file to it. After the report
is generated, CALLS.SAV is updated to include the new data. Here
is a recommended EVENT.SYS sequence:
1. cd \pcb
2. calls main\daycal gen\blt3 zzAzNBCDEFGHIJKLM 2
3. type main\daycal >>main\caller
4. del main\daycal
Use PCBSETUP to change the caller log filename from the usual
'caller' to 'daycal' - this will be your "daily caller log".
Line 2 runs the caller log report on the daily log and generates
BLT3. Line 3 adds the daily caller log to the end of the
"historical" caller log. Line 4 deletes the daily log (pcboard
will make a new one for you).
If you are short on disk space, you don't even need to keep the
'main\caller' - just delete it. The information in CALLS.SAV will
be enough to generate the full caller log report.
If for some reason you want to start over with a fresh log, just
delete 'calls.sav' and calls.exe will create a new one for you.
If you don't want to take advantage of this 'daily caller log'
feature, just add the line
del calls.sav
before the 'calls \pcb\main ...' line in your event.sys - without
the .sav file, it will act just like it used to.
Note: if you run CALLS twice on the same caller log, the
information will be added to CALLS.SAV twice! So, either make a
backup copy of CALLS.SAV, or always delete daycal when you run
calls.
Version 12s11 16-Jan-88 S.H.Smith
-----------------------------------------------------------------------
Moved security related statistics to a new report (code 'N'). Added
a fourth parameter to specify the minimum number of downloads
needed to include a file in the files-downloaded report.
Version 12s10 31-Dec-87 S.H.Smith
-----------------------------------------------------------------------
Sorted entries in system statistics report. Added reporting of
Archive test runs, archive extract runs and re-arc runs.
Version 12s9 27-Dec-87 S.H.Smith
-----------------------------------------------------------------------
Added a third command-line parameter to specify the reports to
generate. This lists the specific report sections to produce and
the order in which they will appear.
If, for example, you wanted to produce only the hourly usage (D),
bulletins read (F), and system statistics (A) reports (in that
order), the command line would be:
calls \pcb\main\caller \pcb\gen\blt3 DFA
-----------------------------------------------------------------------
Version 12s7 21-Dec-87
Version 12s6 29-Nov-87
Version 12s5 20-Nov-87
Version 12s4 07-Nov-87
Version 12s3 12-Oct-87
Version 12s1 10-Oct-87
ORIGINAL DOCUMENTATION
======================
Phoenix Arizona Feb 23, 1987
This documentation covers version 11.8 of CALLS118.COM, a
call analyzer for PCBoard 11.8.
It was written in Turbo Pascal, and is in it's 7th update
with this version. Previous versions had various names and
version numbers such as "pcbcalls", "calls5b" etc. From now on,
it will carry the same version number as PCBoard. If any
revisions are made or required, it will have a letter suffix. (ie
117b).
This version contains only minor mods to include changes made
in going from 11.6 to 11.7. The Imodem and Gmodem protocols have
been added, some minor cleanup was done on the displays, and the
error file, BLT99.DOC has been eliminated as redundant and of not
much value.
OPERATION
This version works pretty much the same as all previous
versions with the exception that the error file "BLT99.DOC" has
been eliminated.
The program is very easy to run, requiring only access to the
callers file. This can be done in one of two ways: If you run it
from your 'MAIN' dir, you can just type CALLS118 and it will
default to an input file name of "CALLERS" and an called
"CALLFILE.DOC".
It will also support command line parameters, so you can use
it in a batch file or in your "EVENT.SYS" file, as I do. The .COM
file should be in your \PCB dir, though this is not required.
Below is a sample of part of my .SYS file:
calls117 d:\pcb\main\callers e:\pcb\gen\blt10
Both parameters should be specified: the first one tells it where
to find the file (d:\pcb\main\callers) and the name of the callers
file. The second tells it where to put the output file, in this
case I am sending it to Drive D with the name "BLT10".
There are a couple of things that make for better operation:
1. Do not mix callers logs of pcboard 10.0 and 11.7. I have
heard of no problems mixing 11.6, 11.7 and 11.8.
2. For proper operation, your clock and date MUST be correct; if
the programs finds that your log begins in 1987 and ends in 1980,
it will usually abort. If not, the numbers will be totally wrong
in most cases.
It is recommended, though not required, that you start a new
callers log if you are new to this program. It is most accurate
when the log begins with "New callers log initiated "etc.
Please give it a try and let me know what you think of it, as
the only way I can put in needed changes is with feedback from the
users. You can leave any comments at my board (Phoenix Techline)
at 602 936-3058 (1200-9600), 24 hours.
I have included the source code in this version so that it may
be customized if you desire. If you make any major changes or
improvements, please upload them to my board at 602 936 3058.
Warren Lauzon